{
  "cells": [
    {
      "attachments": {},
      "cell_type": "markdown",
      "id": "295cba57-f7fa-44ff-aa49-e9c6352925a2",
      "metadata": {
        "id": "XIyP_0r6zuVc"
      },
      "source": [
        "<!-- Banner Image -->\n",
        "<img src=\"https://uohmivykqgnnbiouffke.supabase.co/storage/v1/object/public/landingpage/brevdevnotebooks.png\" width=\"100%\">\n",
        "\n",
        "<!-- Links -->\n",
        "<center>\n",
        "  <a href=\"https://brev.nvidia.com\" style=\"color: #06b6d4;\">Console</a> •\n",
        "  <a href=\"https://developer.nvidia.com/brev\" style=\"color: #06b6d4;\">Docs</a> •\n",
        "  <a href=\"/\" style=\"color: #06b6d4;\">Templates</a> •\n",
        "  <a href=\"https://discord.gg/NVDyv7TUgJ\" style=\"color: #06b6d4;\">Discord</a>\n",
        "</center>\n",
        "\n",
        "# Run ControlNet Models on Stable Diffusion WebUI, AUTOMATIC1111 🤙\n",
        "\n",
        "Welcome!\n",
        "\n",
        "In this notebook, we will run [ControlNet models](https://github.com/lllyasviel/ControlNet) on the the Stable Diffusion WebUI, AUTOMATIC1111. This UI lets you play around with Stable Diffusion image generatation, and the ControlNet models, without needing any code!\n",
        "\n",
        "For example (please download this notebook to see the examples as images currently don't load on GitHub): \n",
        "\n",
        "<img src=\"https://github.com/lllyasviel/ControlNet/raw/main/github_page/p20.png\" width=\"50%\">\n",
        "<img src=\"https://github.com/lllyasviel/ControlNet/raw/main/github_page/p17.png\" width=\"50%\">\n",
        "\n",
        "See the [Github repo](https://github.com/lllyasviel/ControlNet) for more examples!\n",
        "\n",
        "### Help us make this tutorial better! Please provide feedback on the [Discord channel](https://discord.gg/T9bUNqMS8d) or on [X](https://x.com/harperscarroll).\n",
        "\n",
        "A note about running Jupyter Notebooks: Press Shift + Enter to run a cell. A * in the left-hand cell box means the cell is running. A number means it has completed. If your Notebook is acting weird, you can interrupt a too-long process by interrupting the kernel (Kernel tab -> Interrupt Kernel) or even restarting the kernel (Kernel tab -> Restart Kernel). Note restarting the kernel will require you to run everything from the beginning."
      ]
    },
    {
      "cell_type": "markdown",
      "id": "213a839c-8b72-44c8-aab7-f1672cc7f966",
      "metadata": {
        "id": "hWI-uRLEyRgb"
      },
      "source": [
        "## Let's begin!\n",
        "\n",
        "I used a GPU from [brev.dev](https://developer.nvidia.com/brev). I used an A10G, with 24GB GPU Memory, 16 GB RAM, 120 GB storage. This machine is about $1/hr. \n",
        "\n",
        "Click the badge below to get your preconfigured instance:\n",
        "\n",
        "[![ Click here to deploy.](https://brev-assets.s3.us-west-1.amazonaws.com/nv-lb-dark.svg)](https://brev.nvidia.com/environment/new?instance=A10G:g5.xlarge&diskStorage=120&name=controlnet&file=https://github.com/brevdev/notebooks/raw/main/controlnet.ipynb&python=3.10&cuda=12.0.1)\n",
        "\n",
        "Once you've checked out your machine and landed in your instance page, select the specs you'd like (I used **Python 3.10 and CUDA 12.0.1**; these should be preconfigured for you if you use the badge above) and click the \"Build\" button to build your verb container. Give this a few minutes.\n",
        "\n",
        "A few minutes after your model has started Running, click the 'Notebook' button on the top right of your screen once it illuminates (you may need to refresh the screen). You will be taken to a Jupyter Lab environment, where you can upload this Notebook.\n",
        "\n",
        "Note: You can connect your cloud credits (AWS or GCP) by clicking \"Org: \" on the top right, and in the panel that slides over, click \"Connect AWS\" or \"Connect GCP\" under \"Connect your cloud\" and follow the instructions linked to attach your credentials."
      ]
    },
    {
      "cell_type": "code",
      "execution_count": 1,
      "id": "c8388e79-b453-43bf-a427-ce120d726729",
      "metadata": {},
      "outputs": [
        {
          "name": "stdout",
          "output_type": "stream",
          "text": [
            "Cloning into 'stable-diffusion-webui'...\n",
            "remote: Enumerating objects: 28575, done.\u001b[K\n",
            "remote: Counting objects: 100% (156/156), done.\u001b[K\n",
            "remote: Compressing objects: 100% (94/94), done.\u001b[K\n",
            "remote: Total 28575 (delta 82), reused 107 (delta 60), pack-reused 28419\u001b[K\n",
            "Receiving objects: 100% (28575/28575), 32.74 MiB | 54.86 MiB/s, done.\n",
            "Resolving deltas: 100% (20025/20025), done.\n"
          ]
        }
      ],
      "source": [
        "!git clone https://github.com/AUTOMATIC1111/stable-diffusion-webui.git"
      ]
    },
    {
      "cell_type": "code",
      "execution_count": null,
      "id": "b9e96498-acba-49e4-8158-2c744bd2b38f",
      "metadata": {},
      "outputs": [],
      "source": [
        "!pip install -q -U xformers\n",
        "!sudo apt-get update && sudo apt-get -q install ffmpeg libsm6 libxext6  -y"
      ]
    },
    {
      "cell_type": "code",
      "execution_count": 3,
      "id": "a6a126ac-d815-40f2-8506-d501782924bf",
      "metadata": {},
      "outputs": [],
      "source": [
        "import os\n",
        "os.chdir('stable-diffusion-webui')"
      ]
    },
    {
      "cell_type": "markdown",
      "id": "e0652b11-ebe5-4884-bea7-6be89f08c0e4",
      "metadata": {},
      "source": [
        "## Now run this, and just leave it running! When it completes, a window will pop up with your UI!\n",
        "If you have any issues, go to http://127.0.0.1:7860/ in your browser when you see output like \"Model loaded in 3.0s...\".\n",
        "If you still have issues, run `brev port-forward controlnet -p 7860:7860` on a terminal on your LOCAL machine (i.e. NOT from within this machine/notebook, but on your laptop). If you chose a different machine name, replace `controlnet` with that name."
      ]
    },
    {
      "cell_type": "code",
      "execution_count": null,
      "id": "bb1a74c3-c2f8-4498-8c23-20f2143dcfc2",
      "metadata": {},
      "outputs": [],
      "source": [
        "!bash <(wget -qO- https://raw.githubusercontent.com/AUTOMATIC1111/stable-diffusion-webui/master/webui.sh)"
      ]
    },
    {
      "attachments": {
        "98815b97-abf5-4745-8674-5e4217c6123c.png": {
          "image/png": "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"
        }
      },
      "cell_type": "markdown",
      "id": "8ae6fb9d-d8b1-48a3-9dc4-a54c18257c77",
      "metadata": {},
      "source": [
        "# Install ControlNet\n",
        "\n",
        "In your AUTOMATIC1111 WebUI,\n",
        " 1) Open the \"Extensions\" tab.\n",
        " 2) Click \"Install from URL\".\n",
        " 3) Enter `https://github.com/Mikubill/sd-webui-controlnet.git` into \"URL for extension's git repository\".\n",
        " 4) Press \"Install\".\n",
        " 5) Wait until you see the message \"Installed into /home/ubuntu/stable-diffusion-webui/extensions/sd-webui-controlnet. Use Installed tab to restart\".\n",
        " 6) Go to \"Installed\" tab, click \"Check for updates\", and then click \"Apply and restart UI\". (The next time you can also use these buttons to update ControlNet.)\n",
        " 7) Close the AUTOMATIC1111 WebUI browser. In the Jupyter Lab tabs, go to Kernel -> Interrupt Kernel. \n",
        "\n",
        "Then, run the following cell. AUTOMATIC1111 should pop up again as before, but if you have any issues, go to http://127.0.0.1:7860/ in your browser when you see output like \"Model loaded in 3.0s...\".\n",
        "\n",
        "Now, you should be able to see the ControlNet models in your UI, like so:\n",
        "\n",
        "![image.png](attachment:98815b97-abf5-4745-8674-5e4217c6123c.png)\n",
        "\n",
        "Note that running the models sometimes takes time! You can check the output below for updates on model progress.\n",
        "\n",
        "## Running ControlNet Example\n",
        "\n",
        "[![Running ControlNet Example](https://cdn.loom.com/sessions/thumbnails/bf48068ab5ff4908a3a60303f8f8349a-with-play.gif)](https://www.loom.com/share/bf48068ab5ff4908a3a60303f8f8349a)\n",
        "\n",
        "If you'd like to increase the number of ControlNet units/models, go to Settings --> ControlNet and set \"Multi ControlNet: Max models amount (requires restart)\" to as many as you'd like. Click \"Apply Settings\" and then \"Reload UI\". Note you may need to re-open on a new browser tab/window if it doesn't reload on the same window.\n"
      ]
    },
    {
      "cell_type": "code",
      "execution_count": null,
      "id": "1820f139-dfbd-4b55-90c0-1066a214327f",
      "metadata": {},
      "outputs": [],
      "source": [
        "os.chdir('/home/ubuntu')\n",
        "\n",
        "!curl -s https://packagecloud.io/install/repositories/github/git-lfs/script.deb.sh | sudo bash\n",
        "!sudo apt-get install git-lfs\n",
        "!git lfs install\n",
        "\n",
        "os.chdir('/home/ubuntu/stable-diffusion-webui/extensions/sd-webui-controlnet/models')\n",
        "\n",
        "!git clone https://huggingface.co/lllyasviel/ControlNet-v1-1\n",
        "!git lfs fetch\n",
        "!mv ControlNet-v1-1/*.pth .\n",
        "!rm -rf ControlNet-v1-1\n",
        "\n",
        "os.chdir('/home/ubuntu/stable-diffusion-webui/')\n",
        "\n",
        "!bash <(wget -qO- https://raw.githubusercontent.com/AUTOMATIC1111/stable-diffusion-webui/master/webui.sh)"
      ]
    }
  ],
  "metadata": {
    "kernelspec": {
      "display_name": "Python 3 (ipykernel)",
      "language": "python",
      "name": "python3"
    },
    "language_info": {
      "codemirror_mode": {
        "name": "ipython",
        "version": 3
      },
      "file_extension": ".py",
      "mimetype": "text/x-python",
      "name": "python",
      "nbconvert_exporter": "python",
      "pygments_lexer": "ipython3",
      "version": "3.10.12"
    }
  },
  "nbformat": 4,
  "nbformat_minor": 5
}
